package com.danciyixue.boot.dcyx.service;

import com.danciyixue.boot.dcyx.model.entity.UserWordStatus;
import com.danciyixue.boot.dcyx.model.form.UserWordStatusForm;
import com.danciyixue.boot.dcyx.model.form.UserWordStatusUpdateForm;
import com.danciyixue.boot.dcyx.model.query.UserWordStatusQuery;
import com.danciyixue.boot.dcyx.model.vo.UserWordStatusVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 用户单词学习状态服务类
 *
 * @author youlaitech
 * @since 2025-06-24 15:50
 */
public interface UserWordStatusService extends IService<UserWordStatus> {

    /**
     *用户单词学习状态分页列表
     *
     * @return {@link IPage<UserWordStatusVO>} 用户单词学习状态分页列表
     */
    IPage<UserWordStatusVO> getUserWordStatusPage(UserWordStatusQuery queryParams);

    /**
     * 获取用户单词学习状态表单数据
     *
     * @param id 用户单词学习状态ID
     * @return 用户单词学习状态表单数据
     */
     UserWordStatusForm getUserWordStatusFormData(Long id);

    /**
     * 新增用户单词学习状态
     *
     * @param formData 用户单词学习状态表单对象
     * @return 是否新增成功
     */
    boolean saveUserWordStatus(UserWordStatusForm formData);

    /**
     * 修改用户单词学习状态
     *
     * @param id   用户单词学习状态ID
     * @param formData 用户单词学习状态表单对象
     * @return 是否修改成功
     */
    boolean updateUserWordStatus(Long id, UserWordStatusForm formData);

    /**
     * 删除用户单词学习状态
     *
     * @param ids 用户单词学习状态ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteUserWordStatuss(String ids);

    /**
     * 新增OR修改用户单词学习状态
     * 1. 先查后改，如果查到则修改、如果未查到则新增
     *
     * @param formData
     * @return
     */
    boolean saveOrUpdateUserWordStatus(UserWordStatusUpdateForm formData);
}
